home *** CD-ROM | disk | FTP | other *** search
/ Chip 1996 November / Chip 11-96.iso / workshop / readme < prev    next >
Text File  |  1996-06-17  |  14KB  |  333 lines
  1. May the spirit of Linux and GNU and all supporting peoble be with you...
  2. No liability for any damage and/or loss of data or whatsoever caused by the
  3. use of this distribution. Its all at your own risk.
  4.  
  5. This small HOWTO file was compiled from:
  6. Peter Sieg        
  7. Rabishauerstr.9
  8. D-37603 Holzminden
  9. GERMANY
  10. Please, if you try Xlinux send me a postcard with a small comment...
  11. Also bug fixes are highly welcome.
  12.  
  13. Source code is available from sunsite.unc.edu/pub/Linux, tsx-11.mit.edu and
  14. various CD-ROM's.
  15.  
  16. Mini Linux will not work with DBLSPACE. Uncompress your drive first.
  17.  
  18. There are two howto files in the /Library directory:
  19. hardware.howto    (english)    explains hardware related questions.
  20. german.howto    (german)    explains german user questions.
  21.  
  22. To install this distribution:
  23. Space required during installation app. 68 MB.
  24. Space required after installation app. 48 MB.
  25. Since Version V951101, all disk except the last one are higher formatted
  26. with the 2m tools (1,8 MB). To access the disk, you must insert the last
  27. disk first and do a a:\2m.com to install the driver. This driver can also
  28. read and write all other formats transparantly...
  29. x:  (where x is your destination drive to install to)  
  30. md \tmp  (if not already exist)
  31. cd \tmp
  32. Now for all disk:
  33. copy a:\*.*
  34. unrar x xlinux 
  35. del xlinux.r??
  36. Now you can start linux with linux.bat <x>!!!
  37.  
  38. ATTENTION:
  39. Now you can easily setup your keyboard layout, mouse, modem, timezone,
  40. cdrom, swapspace and network by running the setup script in /sbin. 
  41. This script as the related *conf* scripts are adapted from the Slackware 
  42. distribution.
  43. See the copyright notice in setup. - Many thanks to Patrick Volkerding!
  44.  
  45. It will load the portugese keymap. To change to us:
  46. temporarily execute:
  47. /usr/bin/loadkeys /usr/lib/kbd/keytables/us.map
  48. ('/' key is '" key...)
  49. than change file /etc/rc.d/rc.keymap...
  50. I did that already...
  51. I also added de.map (German) and es.map (Spanish) to the directory...
  52. X uses a file called .Xmodmap under dir:
  53. /usr/X11/lib/X11/xinit/
  54. If nothing is there it uses us layout.
  55. I copied xmodmap.gr, *.uk etc in that dir. Please just rename if needed.
  56.  
  57. /dev/modem is linked to /dev/cua1 which is for dos users com2.
  58. to change for example to com1 do:
  59. rm /dev/modem; ln -s /dev/cua0 /dev/modem
  60.  
  61. /dev/mouse is linked to /dev/ttyS0 which is for dos users com1.
  62. to change to com2 etc. do:
  63. rm /dev/mouse; ln -s /dev/ttyS1 /dev/mouse
  64.  
  65. X Version is X11R5!!
  66. Xwindows: my mouse did not work. caused by selection program started in
  67. /etc/rc.d/rc.local
  68. just comment the lines out and restart.
  69. Xwindows needs at least 8MB of memory. If you have less you should use
  70. a swapfile:
  71. dd if=/dev/zero of=/swapfile bs=1024 count =4096 # or 8192...
  72. mkswap /swapfile 4096
  73. sync
  74. swapon /swapfile
  75. # Only the last command have to be repeated each time you boot!!
  76. # or put the folowing line in /etc/fstab:
  77. /swapfile    none    swap    defaults
  78. # or use the script swap <size_in_bytes> in /usr/bin...
  79. # if you dont specify the sizes, just swapon /swapfile will be executed!
  80.  
  81. The following have been removed:
  82. /bin/more (now a link to /usr/bin/less)
  83. /usr/bin/zip
  84. /usr/bin/zipnote
  85. /usr/bin/zipsplit
  86. /usr/bin/lharc
  87. /usr/bin/zoo
  88. /usr/bin/*less*
  89. /usr/bin/*joe*
  90. /usr/lib/joerc
  91. /usr/lib/setup/* (replaced with /sbin/*conf* and /sbin/setup)
  92. /bin/dir (replaced with scripts ls -l $1)
  93. /usr/local/bin/* (utree)
  94. /usr/local/lib/utree.*
  95. /var/adm/packages/*
  96. /var/adm/disk_contents..
  97. /root/xmosaic (don't worry; back in right dir and with local home page!)
  98. /usr/lib/lynx..
  99. /usr/bin/lynx (again don't worry; back with local home page!)
  100. /usr/bin/tin
  101. /usr/bin/indent
  102. /bin/bash (replaced with ash)
  103. /usr/X11/bin/XF86_SVGA (replaced with XF86_Mono)
  104.  
  105. The following programs have been added:
  106. /usr/X11/bin/XF86_Mono (as a replacement for XF86_SVGA)
  107. /bin/ash (as a replacement for bash)
  108. /bin/test (needed by a lot programs? was missing?)
  109. /bin/[ ( link to /bin/test for better readability)
  110. /usr/bin/less (the better more)
  111. /usr/bin/basic (ChipMunk Basic Interpreter V1.0)
  112. /usr/bin/sc (The spreadsheet program V6.21)
  113. /usr/bin/ssfile (A flat file B-Tree data base program that uses ncurses)
  114. /usr/lib/ssfile/ (examples and documentation for ssfile)
  115. /usr/bin/mc (Norton Commander Clone - Excellent!!! - new Version since 1996)
  116. /usr/bin/xc (Communication Program)
  117. /usr/bin/flip (plays fli + flc animations with svgalib - not tested.)
  118. /usr/bin/mpeg_play (play mpg software video files)
  119. /usr/bin/pcdview (displays PhotoCD images with svgalib - not tested.)
  120. /usr/TeX/* (Small TeX distribution...)
  121. /usr/bin/texmgr (TeX Menu using dialog)
  122. /usr/bin/lynx (Character mode WWW client with /usr/lib/html/home.html home page)
  123. /usr/local/lib/lynx.cfg (config file for above...)
  124. /usr/local/lib/*libvga.config (svgalib config file + setup template)
  125. /usr/games/lr (lode runner game svgalib)
  126. /usr/bin/3d (svgalib demo)
  127. (Note: for the two games above, go in the binary directory before starting the game!)
  128. /usr/X11/bin/xspread (same as SC under X)
  129. /usr/X11/bin/oleo (oleo spreadsheet from GNU)
  130. /usr/X11/bin/xcalc (X calculator)
  131. /usr/X11/bin/xeyes (I love this...)
  132. /usr/X11/bin/xtetris (nice game)
  133. /usr/X11/bin/xpool (pool table game)
  134. /usr/X11/bin/xtron (tron like game)
  135. /usr/X11/bin/xmessage (might be usefull)
  136. /usr/X11/bin/xtalk (same as talk under X)
  137. /usr/X11/bin/xgrab (X screen copy)
  138. /usr/X11/bin/xsysinfo (System info display)
  139. /usr/X11/bin/xhtalk (See who is talking too - needs file .xhtalk under your home dir)
  140. /****************************************/
  141. /* sample configuration file for xhtalk */
  142. /* names of the hosts to be searched on .. */
  143. host {     
  144.     "slip1","slip2"      /* local hosts        */
  145. }
  146. /* login names of the users to be searched for ..   */
  147. name {
  148.     "root",
  149.     "sysop",
  150.      "guest"
  151. }
  152. /usr/X11/bin/xedit (Tiny X editor)
  153. /usr/X11/bin/axe (A better xeditor)
  154. /usr/X11/bin/xcoral (A very good xeditor)
  155. /usr/X11/bin/ghostview (Postscript viewer)
  156. /usr/X11/bin/xhtml (A html editor)(removed as extra tgz file)
  157. /usr/X11/bin/xmosaix (WWW client; loads /usr/lib/html/home.html)
  158.                      (when called from fvwm)!
  159. /usr/lib/html/UserGuide/* (XMosaic User Guide; load local XMosaic.0.html)
  160. /usr/X11/bin/xfig (Drawing program)
  161. /usr/X11/bin/fig2dev (Converts *.fig files to various other formats ex: *.ps)
  162. /usr/X11/bin/xv (Picture manipulations)
  163. /lib/libgr.so.1 (needed for xv)
  164. /usr/X11/bin/xpaint (Painting program)
  165. /lib/libXpm.so.4 (needed for xpaint)
  166. /usr/bin/SuperProbe (identifies your display adapter...)
  167. /usr/bin/seejpeg (jpeg... viewer. try run startrek...)
  168. /usr/bin/tclsh (tcl shell)
  169. /usr/lib/libtcl.so.3 (needed for tclsh)
  170. /usr/bin/wish (tk shell)
  171. /usr/lib/libtk.so.3 (needed for tk shell wish)
  172. /usr/lib/tk/demos/* (some demos) 
  173. #you need to place -font fixed before every -text statement!!
  174. /usr/bin/awk (is GNU-awk; required by Crack)
  175. /usr/bin/perl (the script language V4.036)
  176. /usr/bin/sqprint (perl script to print on HP PCL printer two pages on one in
  177.                   landscape format: ex: cat /howto | sqprint | lpr)
  178. /usr/bin/p2p (does the above ex: cat $1 | sqprint | lpr)
  179. /usr/bbs/* (NoName very small bbs program script; follow instructions!)
  180. /usr/bin/deliver (small local! mail delivery program)
  181. /usr/bin/mail (Mail/mailx...to make it work it wrote this script:
  182. /usr/bin/sendmail  
  183. #!/bin/sh
  184. deliver $2
  185. #then ln -s /usr/bin/sendmail /usr/lib/sendmail
  186. /usr/bin/gs (ghostscript postscript interpreter plus several other files)
  187. /usr/lib/ghostscript/* (files needed for gs plus examples; gs -h for help)
  188.                        (try gs /usr/lib/ghostscript/examples/tiger.ps)
  189. /usr/bin/pgs (print postscript files to lpr; param 2 is device name from gs -h)
  190.              (You have to enter <return> and quit manually until solved...)
  191.              (This is solved: specified quit.ps after ps file in pgs...)
  192.              (Also put :mx#0: in /etc/printcap to spool files > 1MB!!!)
  193. /usr/bin/dgs (output postscript files to linux svgaconsole)
  194. /usr/bin/pstree (Perl script - convert/print dir-tree info in postscript)
  195. /usr/bin/i2ps (Perl script - convert/print ascii files to postscript)
  196. /usr/bin/nenscript (program to print ascii files to postscript)
  197. /usr/bin/pstext (script calls nenscript to cvt ascii to ps; stdout)
  198. /usr/bin/a2ps (another script calling nenscript...)
  199. /usr/bin/mpage (print multiple pages of ascii files to postscript)
  200. /usr/bin/a2x* (ascii to postscript)
  201. /usr/bin/fax (scripts sends, receives, prints and views fax with efax,efix,gs)
  202. /usr/bin/efax + efix (used by above script)
  203. /usr/bin/rot13 (simple ascii file scrambler)
  204. /usr/bin/crypt (better ascii file scrambler)
  205. /usr/bin/makekey (needed by crypt)
  206. /usr/bin/tcx + untcx (on the fly exec compress/decompress using gzip)
  207. /usr/bin/lbu + /usr/lib/LBU/* (linux backup utility script using dialog)
  208. /usr/bin/cdrom (mount /dev/cdrom to /cdrom)
  209. /usr/bin/a: (mount msdos /dev/fd0 /a:)
  210. /usr/local/InterViews/*
  211. -- doc (Text processing WYSIWYG; output LaTeX compatible)
  212.        (ca also include drawings etc.)
  213. -- idraw (Drawing program; works with doc; output EPS)  
  214. /usr/local/Minerva/*
  215. /usr/local/Minerva/bin/msql - interactive SQL database manipulation tool
  216. /usr/local/Minerva/bin/msqld - SQL database backend server 
  217. /usr/local/Minerva/bin/msqladmin - SQL database adminstration tool
  218. ( start msqld with: #msqld &)
  219. ( try msql;select num from test; \g)
  220. ( try msql;insert into test(num) values (13) \g)
  221. /usr/local/bin/xlispstat - statistical analysis
  222. /usr/local/lib/xliststat/*
  223. /usr/local/sbin/httpd - NCSA HTTP daemon
  224. /usr/doc/httpd/*
  225. /var/httpd/*
  226. /usr/bin/joe - joe's own editor - Wordstar (TM) commands!
  227. /usr/lib/joe/* 
  228. /usr/bin/wine - the windows emulator (sorry older version = just sol.exe?)
  229. /usr/bin/sysres.dll - needed by wine
  230. /etc/wine.conf - as the name says...
  231. /usr/local/lib/nexs - the network spreadsheet - evaluation copy only
  232.                       see file /Library/nexs.txt
  233. /usr/local/linuxdoc-sgml/* - the linux doc project files and programs
  234. /usr/bin/ci,co,rcs,rcsdiff... - the rcs = revision control system
  235. /usr/bin/xcbb - starts the check book balancer programm (X11!)
  236. /usr/local/cbb/*
  237. /usr/lib/cbb/*
  238. /usr/bin/groff... - the text formatter...with utilities...
  239. /usr/bin/man - a simple shell script to look for a man page
  240. (MANPATH is set in /etc/profile to /cdrom/man, since the man pages are only on
  241.  the cdrom included!
  242. )
  243. /usr/bin/chess - the GNU chess programm for text console
  244. /usr/bin/bwbasic - basic interpreter
  245. /usr/local/bin/cman* - Rolodex Contact manager uses Curses
  246. /usr/bin/ecu - Terminalprogramm also incl. Kermit sr
  247. /usr/local/lib/ecu* see above
  248. /usr/local/bin/*cr - crisp editor plus xcr for X11
  249. /usr/local/lib/crisp/* - see above
  250. /usr/local/pcemu - DOS Emulator under X11 for Textprograms only!
  251. /usr/X11R6/lib - X11R6 libraries needed also by pcemu...
  252. /usr/bin/udo - Text Converter to html,rtf,man,tex,asc,...... Excellent!
  253. /Library/*udo* - some information on udo...
  254.  
  255. This packages/programs i would like to include in this distribution:
  256. PCMCIA support thru loadable kernel modules.
  257. Newer WINE binary.
  258.  
  259. If you like to install other packages, i did it the following way:
  260. # Because the cdrom on my computer did not work at the time...
  261. I selected the appropriate packages <*.tgz> and copied them with the 
  262. windows filemanager from a cdrom to disk a:
  263. Then i started linux:
  264. With cd /tmp i go into the tmp directory.
  265. With mcopy a:<package.tgz> <package.tgz> i copied the file(s) into
  266. the current directory.
  267. With tar -zxvf <package.tgz> i uncompressed and untared them.
  268. Now you will see several directories and files in the /tmp directory.
  269. Try the executables and if you want to keep them move all neccessary
  270. files to their directories ex: /tmp/usr/bin/ash -> /usr/bin/ash.
  271.  
  272. For working with dos floppy disk to can use the mtools:
  273. ex: mdir a: - directory of drive a:
  274.     mread -t a:howto howto - read file howto from a: to current directory
  275.     mwrite -t howto a: - write file howto to drive a:
  276. (-t switch translates <lf> to <cr><lf> and vice versa...)
  277.  
  278. For DOS users i made a link from del to rm and from copy to cp.
  279. That means you can use del to delete files and copy to copy them.
  280. Also md is linked to mkdir and rd to rmdir.
  281.  
  282. You can print ascii files with following command:
  283. p <filename> ;this is just a script under /usr/bin that inserts a <cr> at
  284. the end of each line and then calls lpr.
  285. This is the script p:
  286. #!/bin/sh
  287. cat $1 | sed -e s/$/^M/ | lpr
  288. # ^M is CTRL-M; Use CTRL-V, CTRL-M in vi.
  289. There is also a small script called pap under /usr/bin to allow printing
  290. of attributes like bold and underline. In your text include:
  291. .B for bold on
  292. .b for bold off
  293. .U for underline on
  294. .u for underline off
  295. The script simply replaces this strings with the appropriate control codes.
  296. Currently the codes are set for HP Laserjet PCL and testet with HP Laserjet 4L.
  297. Under /root is a small print.test file. Try pap print.test.
  298.  
  299. You get help on commands by run <cmd> --help or -?.
  300.  
  301. Try working with scripts together with the dialog program, see ex.
  302. under /var/adm/scripts.
  303.  
  304. There is a nice monitor program. run top.
  305.  
  306. If you know Norton Commander run mc.
  307.  
  308. Try the game sasteroids.
  309. For the game lr, please cd /usr/games first...
  310. The file svgalib.config is in /usr/local/lib!
  311.  
  312. Workbone is nice audio cdrom player.
  313.  
  314. There are some setup scripts in /var/adm/scripts/
  315. I used one to setup my cdrom (mitsumi).
  316.  
  317. If you want to work on 2 sessions on one screen try splitvt.
  318.     
  319. To see if your mouse works, try test-mouse.
  320.  
  321. To check if Xwindows would run try X -probeonly.
  322. If the message says, dot clock not found, update the lowes available
  323. dot clock reported by X -probeonly in file Xconfig at mode "640x480"!
  324. and the "800x600" mode as well! That should as least bring you up in X.
  325. In Xwindows you can abort with CTRL-ALT-BACKSPACE.
  326. The first time you should start with startx 2>startx.log.
  327. All messages from x will be logged in startx.log.
  328. I you like a nice background picture in your X desktop try:
  329. # xv -root -max -quit </usr/lib/pictures/picture_filename> &
  330.  
  331. ---------- to be continued ------------
  332.  
  333.